@gitlab/ui/dist/vendor/bootstrap-vue/src/components/table/helpers/mixin-caption.js

GitLab UI Components

import { extend } from '../../../vue';
import { SLOT_NAME_TABLE_CAPTION } from '../../../constants/slots';
import { htmlOrText } from '../../../utils/html';

// --- Props ---

const props = {
  caption: {
    type: String,
    required: false,
    default: undefined
  },
  captionHtml: {
    type: String,
    required: false,
    default: undefined
  }
  // `caption-top` is part of table-render mixin (styling)
  // captionTop: makeProp(PROP_TYPE_BOOLEAN, false)
};

// --- Mixin ---

// @vue/component
const captionMixin = extend({
  props,
  computed: {
    captionId() {
      return this.isStacked ? this.safeId('_caption_') : null;
    }
  },
  methods: {
    renderCaption() {
      const caption = this.caption,
        captionHtml = this.captionHtml;
      const h = this.$createElement;
      let $caption = h();
      const hasCaptionSlot = this.hasNormalizedSlot(SLOT_NAME_TABLE_CAPTION);
      if (hasCaptionSlot || caption || captionHtml) {
        $caption = h('caption', {
          attrs: {
            id: this.captionId
          },
          domProps: hasCaptionSlot ? {} : htmlOrText(captionHtml, caption),
          key: 'caption',
          ref: 'caption'
        }, this.normalizeSlot(SLOT_NAME_TABLE_CAPTION));
      }
      return $caption;
    }
  }
});

export { captionMixin, props };