更新记录

1.0.8(2024-08-09) 下载此版本

示例代码重构

1.0.7(2024-08-09) 下载此版本

修复示例报错

1.0.6(2024-08-06) 下载此版本

修改文档

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

r-date-picker

r-date-picker 日期选择器,用于选择年、月、日、时、分、秒,通常与 r-popup 组件配合使用。

示例

<template>
  <r-config-provider :themeName="themeName">
    <page-header title="日期选择"></page-header>
    <view style="padding: 20rpx 0">
      <r-cell-group inset>
        <r-cell
          title="基本使用"
          is-link
          @click="
            open({
              title: '基本使用',
            })
          "
        ></r-cell>

        <r-cell
          title="加载中"
          is-link
          @click="
            open({
              title: '加载中',
              loading: true,
            })
          "
        ></r-cell>

        <r-cell
          title="使用年"
          is-link
          @click="
            open({
              title: '使用年',
              columnsType: 'year',
            })
          "
        ></r-cell>
        <r-cell
          title="使用年月"
          is-link
          @click="
            open({
              title: '使用年月',
              columnsType: 'month',
            })
          "
        ></r-cell>

        <r-cell
          title="使用时间到秒"
          is-link
          @click="
            open({
              title: '使用时间到秒',
              columnsType: 'second',
            })
          "
        ></r-cell>

        <r-cell
          title="格式化"
          is-link
          @click="
            open({
              title: '格式化',
              formatter: [
                {
                  type: 'year',
                  fn: (e) => {
                    e.item[e.fields.text] = e.item[e.fields.text] + '年';
                    return e.item;
                  },
                },
                {
                  type: 'month',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '月';
                    // console.log(&quot;e&quot;, e);
                    return e.item;
                  },
                },
                {
                  type: 'day',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '日';
                    return e.item;
                  },
                },

                {
                  type: 'hour',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '时';
                    return e.item;
                  },
                },

                {
                  type: 'minute',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '分';
                    return e.item;
                  },
                },
                {
                  type: 'second',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '秒';
                    return e.item;
                  },
                },
              ],
            })
          "
        ></r-cell>

        <r-cell
          title="使用过滤"
          is-link
          @click="
            open({
              title: '使用过滤',
              filter: [
                {
                  type: 'year',
                  fn: (e) => {
                    return e.item[e.fields.value] >= dayjs().year();
                  },
                },
                {
                  type: 'month',
                  fn: (e) => {
                    return e.item[e.fields.value] % 2;
                  },
                },
              ],
            })
          "
        ></r-cell>

        <r-cell
          title="使用时分秒且格式化"
          is-link
          @click="
            open({
              title: '使用时分秒且格式化',
              columnsType: 'second',
              formatter: [
                {
                  type: 'year',
                  fn: (e) => {
                    e.item[e.fields.text] = e.item[e.fields.text] + '年';
                    return e.item;
                  },
                },
                {
                  type: 'month',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '月';
                    // console.log(&quot;e&quot;, e);
                    return e.item;
                  },
                },
                {
                  type: 'day',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '日';
                    return e.item;
                  },
                },

                {
                  type: 'hour',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '时';
                    return e.item;
                  },
                },

                {
                  type: 'minute',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '分';
                    return e.item;
                  },
                },
                {
                  type: 'second',
                  fn: (e) => {
                    e.item[e.fields.text] =
                      (e.item[e.fields.text] < 10
                        ? '0' + e.item[e.fields.text]
                        : e.item[e.fields.text]) + '秒';
                    return e.item;
                  },
                },
              ],
              filter: [
                {
                  type: 'year',
                  fn: (e) => {
                    return e.item[e.fields.value] >= dayjs().year();
                  },
                },
                {
                  type: 'month',
                  fn: (e) => {
                    return e.item[e.fields.value] % 2;
                  },
                },
              ],
              hideFields: ['year', 'month', 'day'],
            })
          "
        ></r-cell>
      </r-cell-group>
    </view>

    <r-popup v-model:show="show" position="bottom">
      <view style="width: 100%">
        <r-date-picker
          v-model:value="currentDate"
          :title="title"
          :loading="loading"
          :formatter="formatter"
          :columnsType="columnsType"
          :filter="filter"
          :hideFields="hideFields"
          @change="change"
          @confirm="confirm"
          @cancel="cancel"
        />
      </view>
    </r-popup>
  </r-config-provider>
</template>
<script setup>
import { ref } from "vue";
import { _, dayjs } from "@/uni_modules/r-utils/js_sdk/index.js";
import useTheme from "@/hooks/useTheme";
const { themeName } = useTheme();

const currentDate = ref([]);
const title = ref("");
const loading = ref(false);
const columnsType = ref("day");
const show = ref(false);
const formatter = ref([]);
const hideFields = ref([]);
const filter = ref([]);

const open = (e) => {
  show.value = true;
  title.value = e.title || "";
  loading.value = e.loading || false;
  columnsType.value = e.columnsType || "day";
  formatter.value = e.formatter || [];
  filter.value = e.filter || [];
  hideFields.value = e.hideFields || [];
};
const change = (e) => {
  console.log("e", e);
};
const confirm = (e) => {
  console.log("e", e);
  show.value = false;
};
const cancel = () => {
  show.value = false;
};
</script>

API

Props

名称 说明 类型 默认值 可选值
value 当前选中项对应的值 Array [] -
columnsFieldNames 自定义 columns 结构中的字段 Object {
text:'text',
value:'value',
children:'children',
}
-
title 顶部栏标题 String - -
confirmButtonText 确认按钮文字 String 确认
cancelButtonText cancelButtonText String 取消
toolbarPosition 顶部栏位置 String top bottom
loading 是否显示加载状态 Boolean false true
showToolbar 是否显示顶部栏 Boolean true false
optionHeight 选项高度 String 44px
visibleOptionNum 可见的选项个数 Number 6
themeName r-theme主题名称 String default
columnsType 选项类型 String day year month day hour minute second
minDate 可选的最小年份 Number | String dayjs().year() - 10
maxDate 可选的最大年份 Number | String dayjs().year() +10
filter 选项过滤函数数组(具体使用可见上方 demo) Array []
formatter 选项格式化函数数组 Array []
hideFields 不显示的字段 (通过该字段可以显示时分秒 或者 月日等场景) Array [] [year ,month, day , hour ,minute ,second ]

Slots

名称 说明 参数
toolbar 自定义整个顶部栏的内容 -
title 自定义标题内容 -
confirm 自定义确认按钮内容 -
cancel 自定义取消按钮内容 -
columnsTop 自定义选项上方内容 -
columnsBottom 自定义选项下方内容 -

Events

名称 说明 参数
confirm 点击完成按钮时触发 { selectedValues, selectedOptions, selectedIndexes }
cancel 点击取消按钮时触发 -
change 选中的选项改变后触发 { selectedValues, selectedOptions, selectedIndexes }
update:value 选中的选项改变时触发 selectedValues

更多组件,请前往rainui

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问