选择器与样式作用域

页面上的样式没有生效时,先检查选择器能否匹配,再检查该样式是否声明在目标组件中。用状态类表示焦点、选中和奇偶行,可以减少迁移时对浏览器选择器的依赖。

写法处理方式
类名、标签、ID、后代和直接子代选择器优先采用简单选择器。在自定义组件中检查样式的声明位置与目标节点的作用域。
[disabled]、[type="primary"]支持存在和精确相等匹配。对应组件需要提供可匹配的属性状态。
[class^="item"]、[name$="x"]、带大小写标志的属性匹配改为明确的状态类,例如 .item-active。
:hover、::before、::afterNova 页面样式表会移除包含这些选择器的规则。用组件按压反馈或真实节点,并把普通类选择器写成独立规则,避免一起被移除。
:root、:not(...)、:active可用 :root 定义固定变量,用 :not(...) 排除某类节点。在不带主题条件的 :root 中声明的变量可能无法被深色主题规则覆盖。迁移主题样式时,可在 :root[theme='dark'] 中声明深色值,并通过 var(--text-color, #161616) 提供默认值。
::placeholder、::selection在对应的输入或文本组件上使用,并确认组件提供相关能力。
:focus、:nth-child(...)用组件的焦点事件和状态类处理。列表的奇偶样式可按索引选择类名。
@supports、@container、@layer不适用。按目标页面直接选择已支持的布局和样式。
@import、@font-face、@keyframes、@mediaNova 支持这些规则。规则内部也只能使用受支持的选择器和属性。

用按压样式替代悬停

在触屏页面,用 view 的 hover-class 给按下的操作项设置反馈。两种写法中,onOpenDetails 是页面中的点击处理函数。

Ray

import { Text, View } from '@ray-js/ray';

export function DeviceRow({ onOpenDetails }: { onOpenDetails: () => void }) {
  return (
    <View className="device-row" hoverClass="device-row-pressed" onClick={onOpenDetails}>
      <Text>查看设备详情</Text>
    </View>
  );
}

原生小程序

<view class="device-row" hover-class="device-row-pressed" bindtap="onOpenDetails">
  <text>查看设备详情</text>
</view>
.device-row {
  padding: 24rpx;
  background-color: #ffffff;
}

.device-row-pressed {
  background-color: #f2f3f5;
}

自定义组件样式

需要修改共享卡片的标题颜色时,先用组件公开的样式类、属性或主题变量。由你维护的组件,也可以把标题样式放到组件自己的样式文件里。组件在两种渲染方式中共用时,分别预览修改后的样式。

窄窗口示例

例如,列表在较宽页面排成两列,在窄页面改成一列。Ray 在容器上设置 className="cards",原生小程序设置 class="cards"。宽度断点用 px,检查 375px 及其两侧的显示效果。

.cards {
  display: grid;
  grid-template-columns: 1fr 1fr;
  column-gap: 16rpx;
  row-gap: 16rpx;
}

@media (max-width: 375px) {
  .cards {
    grid-template-columns: 1fr;
  }
}