@beppla/tapas-ui 1.5.2 → 1.5.6

package/commonjs/DeviceSelectionModal/README.md

@@ -0,0 +1,124 @@
+# DeviceSelectionModal
+
+设备选择模态对话框组件，用于从设备列表中选择一个设备。支持加载状态、错误处理、重试机制和文本国际化，适合打印机选择、终端绑定等硬件设备关联场景。
+
+## 功能特性
+
+- ✅ 单选设备列表（Radio Button 样式）
+- ✅ 加载中状态展示（ActivityIndicator）
+- ✅ 错误状态展示 + 重试按钮
+- ✅ 空列表提示
+- ✅ 设备描述信息展示
+- ✅ 未选择时确认按钮自动禁用
+- ✅ 关闭时恢复原始选中状态
+- ✅ 全部文本支持国际化（i18n props）
+- ✅ 淡入淡出动画
+- ✅ 主题色适配
+
+## 安装使用
+
+```tsx
+import { DeviceSelectionModal } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| visible | `boolean` | - | 是否显示（必填） |
+| devices | `Device[]` | - | 设备列表（必填） |
+| selectedDeviceId | `string` | - | 当前选中的设备 ID |
+| onClose | `() => void` | - | 关闭回调（必填） |
+| onConfirm | `(deviceId: string) => void` | - | 确认选择回调（必填） |
+| title | `string` | - | 对话框标题 |
+| isLoading | `boolean` | `false` | 是否加载中 |
+| error | `string \| null` | `null` | 错误信息 |
+| onRetry | `() => void` | - | 重试按钮回调 |
+| selectDeviceText | `string` | `'Select Device'` | 标题文本 |
+| pleaseSelectDeviceText | `string` | `'Please select a device'` | 副标题文本 |
+| loadingDevicesText | `string` | `'Loading devices...'` | 加载中文本 |
+| noDevicesAvailableText | `string` | `'No devices available'` | 空列表文本 |
+| closeText | `string` | `'Close'` | 关闭按钮文本 |
+| confirmText | `string` | `'Confirm'` | 确认按钮文本 |
+| retryText | `string` | `'Retry'` | 重试按钮文本 |
+| testID | `string` | - | 测试标识 |
+
+### Device 接口
+
+```tsx
+interface Device {
+  id: string;
+  name: string;
+  description?: string;
+}
+```
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+const [visible, setVisible] = useState(false);
+const devices = [
+  { id: '1', name: 'Printer A', description: 'Kitchen printer' },
+  { id: '2', name: 'Printer B', description: 'Receipt printer' },
+];
+
+<DeviceSelectionModal
+  visible={visible}
+  devices={devices}
+  onClose={() => setVisible(false)}
+  onConfirm={(deviceId) => {
+    console.log('Selected:', deviceId);
+    setVisible(false);
+  }}
+/>
+```
+
+### 加载状态
+
+```tsx
+<DeviceSelectionModal
+  visible={true}
+  devices={[]}
+  isLoading={true}
+  onClose={() => setVisible(false)}
+  onConfirm={() => {}}
+/>
+```
+
+### 错误状态 + 重试
+
+```tsx
+<DeviceSelectionModal
+  visible={true}
+  devices={[]}
+  error="Failed to load devices"
+  onRetry={() => fetchDevices()}
+  onClose={() => setVisible(false)}
+  onConfirm={() => {}}
+/>
+```
+
+### 国际化
+
+```tsx
+<DeviceSelectionModal
+  visible={true}
+  devices={devices}
+  selectDeviceText="Select Printer"
+  pleaseSelectDeviceText="Choose a printer for this station"
+  confirmText="Bind"
+  closeText="Cancel"
+  onClose={() => setVisible(false)}
+  onConfirm={handleConfirm}
+/>
+```
+
+## 注意事项
+
+- 关闭对话框时会将内部选中状态恢复为 `selectedDeviceId`（即取消未确认的选择）
+- 未选中设备时确认按钮禁用（灰色样式）
+- 对话框最大宽度 400px，设备列表最大高度 300px
+- `title` 和 `selectDeviceText` 同时存在时，`title` 优先
+- 需在 `ThemeProvider` 内使用

package/commonjs/DraggableFlatList/README.md

@@ -0,0 +1,35 @@
+# DraggableFlatList
+
+可拖拽列表组件占位符。当前为空实现，预留用于后续开发支持拖拽排序的列表功能。
+
+## 功能特性
+
+- ✅ 组件骨架已搭建，导出可用
+- (待开发) 拖拽排序
+- (待开发) 拖拽动画
+- (待开发) 自定义渲染
+
+## 安装使用
+
+```tsx
+import { DraggableFlatList } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| testID | `string` | - | 测试标识 |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+<DraggableFlatList testID="draggable-list" />
+```
+
+## 注意事项
+
+- 当前为空 View 占位实现，无实际拖拽功能
+- 后续计划集成 `react-native-draggable-flatlist` 或自定义实现

package/commonjs/Drawer/README.md

@@ -0,0 +1,175 @@
+# Drawer
+
+抽屉面板组件，从屏幕右侧滑出的浮层面板，支持自定义头部、内容区域和页脚，常用于筛选、详情展示等场景。
+
+## 功能特性
+
+- 从右侧滑出的 Overlay 抽屉面板
+- 响应式宽度（桌面端 55%，移动端 100%）
+- 可自定义标题、标题图标和状态标签（Status 组件）
+- 支持 showHeader / showFooter 控制头部和页脚显示
+- 支持自定义 headerComponent 和 footerComponent 完全替换
+- 点击背景遮罩自动关闭（onBackdropPress）
+- 内容区域自动 ScrollView 滚动
+- 移动端自动适配 Safe Area（useSafeAreaInsets）
+- 页脚包含左侧文本按钮和右侧主按钮
+
+## 安装使用
+
+```tsx
+import { Drawer } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| visible | `boolean` | `false` | 抽屉是否可见 |
+| title | `string` | - | 抽屉标题 |
+| titleIcon | `string` | - | 标题左侧图标名称 |
+| titleIconOnPress | `() => void` | - | 标题图标点击回调 |
+| titleStatus | `string` | - | 状态标签文本 |
+| statusType | `STATUS_TYPE` | `'unavailable'` | 状态类型（success/warning/unavailable 等） |
+| showHeader | `boolean` | `true` | 是否显示头部 |
+| showFooter | `boolean` | `false` | 是否显示页脚 |
+| onClose | `() => void` | - | 关闭回调（背景遮罩点击时触发） |
+| onClear | `() => void` | - | 清空按钮回调（未设时回退到 onClose） |
+| clearText | `string` | - | 清空按钮文本 |
+| clearDisable | `boolean` | `true` | 清空按钮是否禁用 |
+| overlayStyle | `StyleProp<ViewStyle>` | - | 抽屉覆盖层自定义样式 |
+| middleSectionStyle | `StyleProp<ViewStyle>` | - | 内容区域自定义样式 |
+| leftButtonText | `string` | - | 页脚左侧按钮文本 |
+| leftButtonTextStyle | `StyleProp<ViewStyle>` | - | 页脚左侧按钮文本样式 |
+| leftButtonOnPress | `() => void` | - | 页脚左侧按钮回调 |
+| rightButtonText | `string` | - | 页脚右侧按钮文本 |
+| rightButtonStyle | `StyleProp<ViewStyle>` | - | 页脚右侧按钮样式 |
+| rightButtonOnPress | `() => void` | - | 页脚右侧按钮回调 |
+| component | `React.ReactNode` | - | 内容组件（渲染在 children 之前） |
+| children | `React.ReactNode` | - | 内容子组件 |
+| headerComponent | `React.ReactNode` | - | 自定义头部组件（替换默认头部） |
+| footerComponent | `React.ReactNode` | - | 自定义页脚组件（额外渲染在 showFooter 之后） |
+| testID | `string` | - | 测试 ID |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+import { Drawer } from '@beppla/tapas-ui';
+import { useState } from 'react';
+import { Text, Button } from 'react-native';
+
+export default function App() {
+  const [visible, setVisible] = useState(false);
+
+  return (
+    <>
+      <Button title="Open Drawer" onPress={() => setVisible(true)} />
+      <Drawer
+        visible={visible}
+        title="Filters"
+        onClose={() => setVisible(false)}
+      >
+        <Text>Drawer content here</Text>
+      </Drawer>
+    </>
+  );
+}
+```
+
+### 带状态标签和图标
+
+```tsx
+<Drawer
+  visible={visible}
+  title="Order Details"
+  titleIcon="back"
+  titleIconOnPress={() => setVisible(false)}
+  titleStatus="Active"
+  statusType="success"
+  onClose={() => setVisible(false)}
+>
+  <Text>Order information</Text>
+</Drawer>
+```
+
+### 完整功能（头部 + 内容 + 页脚）
+
+```tsx
+<Drawer
+  visible={visible}
+  title="Filters"
+  titleIcon="back"
+  titleIconOnPress={() => setVisible(false)}
+  clearText="Clear"
+  clearDisable={false}
+  onClear={() => resetFilters()}
+  onClose={() => setVisible(false)}
+  showFooter={true}
+  leftButtonText="Close"
+  leftButtonOnPress={() => setVisible(false)}
+  rightButtonText="Show all results"
+  rightButtonOnPress={() => applyFilters()}
+>
+  <Text>Filter options here</Text>
+</Drawer>
+```
+
+### 自定义头部和页脚
+
+```tsx
+<Drawer
+  visible={visible}
+  headerComponent={
+    <View style={{ flexDirection: 'row', justifyContent: 'space-between', padding: 16 }}>
+      <Text style={{ fontSize: 18, fontWeight: 'bold' }}>Custom Header</Text>
+      <Button title="X" onPress={() => setVisible(false)} />
+    </View>
+  }
+  footerComponent={
+    <View style={{ flexDirection: 'row', justifyContent: 'flex-end', gap: 8 }}>
+      <Button title="Cancel" onPress={() => setVisible(false)} />
+      <Button title="Save" onPress={() => handleSave()} />
+    </View>
+  }
+  onClose={() => setVisible(false)}
+>
+  <Text>Content with custom header and footer</Text>
+</Drawer>
+```
+
+### 通过 DrawerContext 使用
+
+```tsx
+import { useContext } from 'react';
+import { DrawerContext } from '@beppla/tapas-ui/components/Layout/DrawerContext';
+
+function MyComponent() {
+  const { open, close } = useContext(DrawerContext);
+
+  const showDrawer = () => {
+    open({
+      title: 'Dynamic Drawer',
+      component: <Text>Dynamic content</Text>,
+      showFooter: true,
+      rightButtonText: 'Confirm',
+      rightButtonOnPress: () => {
+        handleConfirm();
+        close();
+      },
+    });
+  };
+
+  return <Button title="Open" onPress={showDrawer} />;
+}
+```
+
+## 注意事项
+
+- 桌面端抽屉宽度为屏幕的 55%，移动端为 100%
+- `clearDisable` 默认为 `true`（禁用状态），需显式设为 `false` 才能启用清空按钮
+- `onClear` 未设置时，清空按钮会回退使用 `onClose` 回调
+- `showFooter` 默认为 `false`，需显式设为 `true` 以显示页脚按钮区域
+- `footerComponent` 独立于 `showFooter`，即使 `showFooter=false`，`footerComponent` 仍会渲染
+- 内容区域使用 ScrollView 包裹，`contentContainerStyle` 设置了 `flexGrow: 1`
+- 移动端会通过 `useSafeAreaInsets` 自动添加顶部安全区域间距

package/commonjs/Dropdown/README.md

@@ -0,0 +1,230 @@
+# Dropdown / CustomDropdown / InputDropdown
+
+下拉选择组件系列。Dropdown 是主组件，支持普通下拉和 Modal 弹出两种模式；CustomDropdown 是底层下拉容器；InputDropdown 是带搜索输入框的下拉组件。
+
+## 功能特性
+
+- ✅ 两种模式：CustomDropdown 弹出模式和 Modal 弹出模式
+- ✅ 支持搜索过滤选项
+- ✅ 响应式定位，自动检测上下空间选择弹出方向
+- ✅ 移动端自动切换为 BottomSheet 样式
+- ✅ 支持自定义按钮（customButton）
+- ✅ 支持自定义弹出内容（customPopoverContent）
+- ✅ 浮动标签动画（Modal 模式）
+- ✅ 错误状态和状态消息显示
+- ✅ 支持必填标识
+- ✅ InputDropdown 支持输入搜索、清空、只读模式
+- ✅ 支持扩展按钮（extendBtn）
+- ✅ 多种定位方式：left、center、right、upLeft、upRight、upCenter、auto
+
+## 安装使用
+
+```tsx
+import Dropdown from '@beppla/tapas-ui/components/Dropdown/Dropdown';
+import CustomDropdown from '@beppla/tapas-ui/components/Dropdown/CustomDropdown';
+import InputDropdown from '@beppla/tapas-ui/components/Dropdown/InputDropdown';
+```
+
+## Props
+
+### Dropdown Props（核心属性）
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| options | `ItemProps[]` | - | 选项列表 |
+| value | `ItemProps` | - | 当前选中值 |
+| onChange | `(value: ItemProps) => void` | - | 选中变化回调 |
+| prefix | `string` | `''` | 显示值前缀 |
+| width | `number` | - | 按钮宽度 |
+| subWidth | `number` | - | 弹出框宽度 |
+| subHeight | `number` | `150` | 弹出框高度 |
+| type | `'button' \| 'option'` | `'option'` | 类型，button 模式不更新选中值 |
+| onClose | `() => void` | - | 关闭回调 |
+| onPress | `() => void` | - | 按钮点击回调 |
+| onItemPress | `(value: string \| number) => void` | - | button 类型下的选项点击回调 |
+| disabled | `boolean` | - | 是否禁用 |
+| showSearchBar | `boolean` | - | 是否显示搜索栏 |
+| placeholder | `string` | - | 搜索栏占位文字 |
+| onSearchChange | `(value: string) => void` | - | 搜索内容变化回调 |
+| testID | `string` | - | 测试标识 |
+
+### Dropdown Modal 模式属性
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| useModal | `boolean` | `false` | 是否使用 Modal 弹出模式 |
+| dropdownItems | `TapasDropDownItem[]` | `[]` | Modal 模式下的选项列表 |
+| selected | `string` | - | 选中项的 key |
+| showSelectedValue | `boolean` | `false` | 是否显示选中值文字 |
+| dropdownType | `'clear' \| 'solid'` | `'clear'` | 下拉按钮类型 |
+| arrowIcon | `boolean` | `false` | 是否显示箭头图标 |
+| onSelect | `(item: TapasDropDownItem) => void` | - | Modal 模式选择回调 |
+| label | `string` | - | 标签文字 |
+| required | `boolean` | - | 是否必填 |
+| state | `'normal' \| 'error'` | `'normal'` | 状态 |
+| stateMsg | `string` | - | 状态消息 |
+| showStateMsg | `boolean` | `false` | 是否显示状态消息 |
+| showCheckedStatusInList | `boolean` | `false` | 列表中是否高亮选中项 |
+| noLabelAnim | `boolean` | `false` | 是否禁用标签动画 |
+| radius | `number` | `12` | 圆角半径 |
+| backgroundColor | `string` | - | 背景颜色 |
+| labelColor | `string` | - | 标签颜色 |
+| emptyText | `string` | `'No options'` | 空列表提示文字 |
+| extendBtn | `string` | - | 扩展按钮文字 |
+| extendBtnIcon | `string` | - | 扩展按钮图标 |
+| onExtendBtnPress | `() => void` | - | 扩展按钮回调 |
+| customPopoverContent | `React.ReactNode` | - | 自定义弹出内容 |
+| modalVisible | `boolean` | - | 控制 Modal 可见性 |
+| setModalVisible | `(val: boolean) => void` | - | 设置 Modal 可见性回调 |
+| iconStyle | `ViewStyle \| TextStyle` | - | 图标样式 |
+| offsetWidth | `number` | `0` | 偏移宽度 |
+
+### CustomDropdown Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| children | `React.ReactNode` | - | 弹出框内容 |
+| value | `string` | - | 按钮显示文字 |
+| onPress | `() => void` | - | 按钮点击回调 |
+| onClose | `() => void` | - | 关闭回调 |
+| isVisible | `boolean` | - | 是否展开 |
+| width | `number` | `80` | 按钮宽度 |
+| subWidth | `number` | `250` | 弹出框宽度 |
+| subHeight | `number` | `258` | 弹出框高度 |
+| icon | `any` | - | 自定义图标 |
+| subContainerPosition | `TDropdownPosition` | `'left'` | 弹出位置 |
+| subContainerTop | `number` | - | 自定义 top 值（优先级最高） |
+| subContainerLeft | `number` | - | 自定义 left 值（优先级最高） |
+| customButton | `React.ReactNode` | - | 自定义触发按钮 |
+| dropdownButtonStyle | `StyleProp<ViewStyle>` | - | 按钮样式 |
+| dropdownButtonSelectedStyle | `StyleProp<ViewStyle>` | - | 选中时按钮样式 |
+| dropdownButtonHoverStyle | `StyleProp<ViewStyle>` | - | hover 时按钮样式 |
+| sheetTitlePros | `SheetTileProps` | - | 移动端 BottomSheet 标题配置 |
+| dropdownBackgroundColor | `string` | - | 自定义弹出框背景色 |
+
+### InputDropdown Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| label | `string` | - | 输入框标签（必填） |
+| value | `ItemProps` | - | 当前选中值 |
+| options | `ItemProps[]` | - | 选项列表 |
+| onChange | `(value?: ItemProps) => void` | - | 选中变化回调 |
+| onSearch | `(value: string) => void` | - | 搜索回调 |
+| required | `boolean` | - | 是否必填 |
+| readOnly | `boolean` | - | 是否只读 |
+| clearable | `boolean` | - | 是否可清空 |
+| disabled | `boolean` | - | 是否禁用 |
+| defaultShowLabel | `boolean` | - | 默认是否显示标签 |
+| labelBg | `string` | - | 标签背景色 |
+| labelColor | `string` | - | 标签颜色 |
+| allCreate | `boolean` | - | 是否允许自定义输入值 |
+| labelPosition | `'top' \| 'middle'` | - | 标签位置 |
+| children | `React.ReactNode` | - | 自定义下拉内容 |
+
+### TapasDropDownItem 数据类型
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| key | `string \| number` | 选项唯一标识 |
+| value | `string` | 选项显示文字 |
+| secondaryValue | `string` | 次要显示文字（可选） |
+
+## 使用示例
+
+### 基础下拉
+
+```tsx
+const [isVisible, setIsVisible] = useState(false);
+const [value, setValue] = useState(options[0]);
+
+<Dropdown
+  title="Name"
+  options={options}
+  value={value}
+  width={150}
+  subWidth={150}
+  onChange={(val) => { setValue(val); setIsVisible(false); }}
+  isVisible={isVisible}
+  onClose={() => setIsVisible(false)}
+  onPress={() => setIsVisible(!isVisible)}
+/>
+```
+
+### 带搜索的下拉
+
+```tsx
+<Dropdown
+  title="Name"
+  options={options}
+  value={value}
+  showSearchBar={true}
+  subWidth={200}
+  onSearchChange={(val) => console.log(val)}
+  isVisible={isVisible}
+  onClose={() => setIsVisible(false)}
+  onPress={() => setIsVisible(!isVisible)}
+  onChange={(val) => setValue(val)}
+/>
+```
+
+### InputDropdown（可搜索输入下拉）
+
+```tsx
+<InputDropdown
+  label="选择名称"
+  options={options}
+  value={selectedValue}
+  clearable
+  labelBg="#fff"
+  isVisible={isVisible}
+  onClose={() => setIsVisible(false)}
+  onPress={() => setIsVisible(!isVisible)}
+  onChange={(val) => setValue(val)}
+/>
+```
+
+### 自定义按钮
+
+```tsx
+<Dropdown
+  options={options}
+  value={value}
+  customButton={
+    <View style={{ width: 48, height: 40, justifyContent: 'center', alignItems: 'center' }}>
+      <Icon name="more_vert" size={20} />
+    </View>
+  }
+  isVisible={isVisible}
+  onClose={() => setIsVisible(false)}
+  onPress={() => setIsVisible(!isVisible)}
+  onChange={(val) => setValue(val)}
+/>
+```
+
+### Modal 模式
+
+```tsx
+<Dropdown
+  useModal={true}
+  dropdownItems={[
+    { key: '1', value: '选项一' },
+    { key: '2', value: '选项二' },
+  ]}
+  selected="1"
+  showSelectedValue={true}
+  dropdownType="solid"
+  label="选择"
+  onSelect={(item) => console.log(item)}
+/>
+```
+
+## 注意事项
+
+- 普通模式下需要手动管理 `isVisible` 状态
+- Web 端点击外部会自动关闭弹出框（通过 document click 事件）
+- 移动端自动使用 BottomSheet 展示
+- `subContainerTop` 和 `subContainerLeft` 优先级高于 `subContainerPosition`
+- Modal 模式下弹出位置会自动检测屏幕空间，优先向下展示
+- `type="button"` 时点击选项不会更新选中值，仅触发 `onItemPress`
+- InputDropdown 在 `allCreate` 为 false 时，失焦后会恢复为选中值

package/commonjs/ExternalLink/README.md

@@ -0,0 +1,81 @@
+# ExternalLink
+
+外部链接组件，用于打开外部 URL。自动适配 Web（window.open）和移动端（Linking.openURL）平台差异，提供统一的外链交互体验。
+
+## 功能特性
+
+- ✅ 跨平台链接打开：Web 新标签页、移动端外部浏览器
+- ✅ 移动端自动检测 URL 可用性（Linking.canOpenURL）
+- ✅ 支持自定义点击行为（onPress 覆盖默认行为）
+- ✅ 文本子元素自动包装 Text 组件
+- ✅ 自定义链接和文本样式
+- ✅ 默认下划线链接样式
+- ✅ 主题色适配（primary 色）
+
+## 安装使用
+
+```tsx
+import { ExternalLink } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| href | `string` | - | 目标 URL（必填） |
+| children | `React.ReactNode` | - | 链接内容（必填） |
+| style | `any` | - | 外层容器样式 |
+| textStyle | `any` | - | 文本样式 |
+| onPress | `() => void` | - | 自定义点击行为（覆盖默认打开链接） |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+<ExternalLink href="https://beppla.com">
+  Visit BEPPLA
+</ExternalLink>
+```
+
+### 自定义样式
+
+```tsx
+<ExternalLink
+  href="https://docs.beppla.com"
+  textStyle={{ color: '#895F38', fontSize: 14 }}
+>
+  Documentation
+</ExternalLink>
+```
+
+### ReactNode 子元素
+
+```tsx
+<ExternalLink href="https://support.beppla.com">
+  <View style={{ flexDirection: 'row', alignItems: 'center' }}>
+    <TapasIcon name="help" size={16} />
+    <Text style={{ marginLeft: 4 }}>Help Center</Text>
+  </View>
+</ExternalLink>
+```
+
+### 自定义点击行为
+
+```tsx
+<ExternalLink
+  href="https://example.com"
+  onPress={() => trackLinkClick('example')}
+>
+  Custom handler
+</ExternalLink>
+```
+
+## 注意事项
+
+- 字符串类型的 children 自动包装为 Text 组件并应用 textStyle
+- 非字符串类型的 children 直接渲染，textStyle 不生效
+- 移动端打开前会检查 `Linking.canOpenURL`，不支持的 URL 会在控制台警告
+- `onPress` 存在时不会打开 href 链接
+- 默认文本样式：主题 primary 色、下划线、fontSize 16
+- 需在 `ThemeProvider` 内使用