安卓仿联系人索引列表 A到Z排序查询

本文章是看了xiaanming大哥的文章自己笔记整理的，自己加了些更多注释和自己的理解.

原文：http://blog.csdn.net/xiaanming/article/details/12684155

思路：

1.自定义的View，当点击这个view时会获取出点击的位置，根据比例关系算出点击的是第几个字母，

if (mTextDialog != null) {mTextDialog.setText(b[c]);mTextDialog.setVisibility(View.VISIBLE);}

这个个setTextView(TextView mTextDialog)方法会传入dialog，之后就是让他显示或隐藏，

if (listener != null) {listener.onTouchingLetterChanged(b[c]);}

然后这个接口会回调到activity把计算出来的是那个字母发过去。这个自定义的大概逻辑就是这些。

2，在activity中设置的自定义的view监听事件中，实现的这个方法会发过来当前点击的是那个字母，然后在根据这个字母，获取这个字母的第一次出现在哪个位置

position = adapter.getPositionForSection(s.charAt(0));

这个position就是位置，s.charAt（0）这个是字符串的首字母

listView.setSelection(position);

这个方法会直接跳到该字母的第一个位置，这就形成了查询

其他的代码中的注释非常详细，如还有不明白可评论或消息，大家一起进步。

1.先自定义view索引

public class SideBar extends View {// 触摸事件private OnTouchingLetterChangedListener onTouchingLetterChangedListener;// 26个字母public static String[] b = { "A", "B", "C", "D", "E", "F", "G", "H", "I","J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V","W", "X", "Y", "Z", "#" };private int choose = -1;// 选中private Paint paint = new Paint();private TextView mTextDialog;public void setTextView(TextView mTextDialog) {this.mTextDialog = mTextDialog;}public SideBar(Context context, AttributeSet attrs, int defStyle) {super(context, attrs, defStyle);}public SideBar(Context context, AttributeSet attrs) {super(context, attrs);}public SideBar(Context context) {super(context);}/*** 画*/protected void onDraw(Canvas canvas) {super.onDraw(canvas);// 获取焦点改变背景颜色.int height = getHeight();// 获取对应高度int width = getWidth(); // 获取对应宽度int singleHeight = height / b.length;// 获取每一个字母的高度for (int i = 0; i < b.length; i++) {paint.setColor(Color.rgb(33, 65, 98));paint.setAlpha(100);// paint.setColor(Color.WHITE);paint.setTypeface(Typeface.DEFAULT_BOLD);paint.setAntiAlias(true);paint.setTextSize(20);// 选中的状态if (i == choose) {paint.setColor(Color.parseColor("#3399ff"));paint.setFakeBoldText(true);}// x坐标等于中间-字符串宽度的一半.float xPos = width / 2 - paint.measureText(b[i]) / 2;// 居中float yPos = singleHeight * i + singleHeight;canvas.drawText(b[i], xPos, yPos, paint);paint.reset();// 重置画笔}}@Overridepublic boolean dispatchTouchEvent(MotionEvent event) {final int action = event.getAction();final float y = event.getY();// 点击y坐标final int oldChoose = choose;// 记录之前点击是第几个final OnTouchingLetterChangedListener listener = onTouchingLetterChangedListener;final int c = (int) (y / getHeight() * b.length);// 点击y坐标所占总高度的比例*b数组的长度就等于点击b中的第几个.switch (action) {// 抬起手指时执行。让中间的dialog消失case MotionEvent.ACTION_UP:setBackgroundDrawable(new ColorDrawable(0x00000000));choose = -1;//invalidate();if (mTextDialog != null) {mTextDialog.setVisibility(View.INVISIBLE);}break;// 除了放开时执行。在本案例中按着滑动时执行default:// 设置右侧字母列表[A,B,C,D,E....]的背景颜色setBackgroundResource(R.drawable.sortlistview_sidebar_background);// 滑动时会一直变化，选中的值也变化，当滑动的幅度小时会等于之前的值所以就不用执行以下方法，// 当值变化不等于之前的值时就得执行，dialog变化，通知list变化if (oldChoose != c) {if (c >= 0 && c < b.length) {if (listener != null) {listener.onTouchingLetterChanged(b[c]);}if (mTextDialog != null) {mTextDialog.setText(b[c]);mTextDialog.setVisibility(View.VISIBLE);}choose = c;invalidate();// 自动清屏以及刷新界面}}break;}return true;}/*** 向外公开的方法* * @param onTouchingLetterChangedListener*/public void setOnTouchingLetterChangedListener(OnTouchingLetterChangedListener onTouchingLetterChangedListener) {this.onTouchingLetterChangedListener = onTouchingLetterChangedListener;}/*** 接口* * @author coder* */public interface OnTouchingLetterChangedListener {public void onTouchingLetterChanged(String s);}}

2.因为要悬浮在上面所以要用FrameLayout

<FrameLayoutandroid:layout_width="fill_parent"android:layout_height="fill_parent"><cn.utils.MySwipeRefreshLayout android:id="@+id/mySwipeRefreshLayout_shang_brs"android:layout_width="match_parent"android:layout_height="match_parent"><ListViewandroid:id="@+id/listView_renshu"android:layout_width="match_parent"android:layout_height="match_parent"android:layout_alignParentLeft="true"android:divider="@null"android:layout_below="@+id/relativeLayout_top"></ListView></cn.utils.MySwipeRefreshLayout><TextViewandroid:id="@+id/dialog"android:layout_width="80.0dip"android:layout_height="80.0dip"android:layout_gravity="center"android:background="#90656565"android:gravity="center"android:textColor="#ffffff"android:textSize="30.0dip"android:visibility="invisible" /><cn.suoyin.SideBarandroid:id="@+id/sidrbar"android:layout_width="30.0dip"android:layout_height="fill_parent"android:layout_marginBottom="10dp"android:layout_gravity="right|center" /></FrameLayout>

3.在activity干或fragment中找出，并设置点击事件

sideBar = (SideBar) findViewById(R.id.sidrbar);dialog = (TextView) findViewById(R.id.dialog);sideBar.setTextView(dialog);// 设置右侧触摸监听sideBar.setOnTouchingLetterChangedListener(new OnTouchingLetterChangedListener() {@Overridepublic void onTouchingLetterChanged(String s) {// 该字母首次出现的位置int position;if (s.equals("#")) {position = adapter.getPositionForSection("|".charAt(0));} else {position = adapter.getPositionForSection(s.charAt(0));}if (position != -1) {listView.setSelection(position);}}});

4.自定义的adapter

public class MinciAdapter extends BaseAdapter implements SectionIndexer {private Context context;private List<Minci> list;public MinciAdapter(Context context, List<Minci> list) {super();this.context = context;this.list = list;}/*** 当ListView数据发生变化时,调用此方法来更新ListView* * @param list*/public void updateListView(List<Minci> list) {this.list = list;notifyDataSetChanged();}@Overridepublic int getCount() {return list.size();}@Overridepublic Object getItem(int position) {return list.get(position);}@Overridepublic long getItemId(int position) {return position;}@Overridepublic View getView(int position, View convertView, ViewGroup parent) {ViewHolder mHolder = null;if (convertView == null) {mHolder = new ViewHolder();convertView = LayoutInflater.from(context).inflate(R.layout.item_minci_layout, parent, false);mHolder.uname = (TextView) convertView.findViewById(R.id.textView_minci_uname);mHolder.departement = (TextView) convertView.findViewById(R.id.textView_minci_departement);mHolder.job = (TextView) convertView.findViewById(R.id.textView_minci_job);mHolder.img = (RoundImageView) convertView.findViewById(R.id.imageView_minci_title);mHolder.minci = (TextView) convertView.findViewById(R.id.textView_minci_mc);mHolder.textView_item_top = (TextView) convertView.findViewById(R.id.textView_item_top);mHolder.time = (TextView) convertView.findViewById(R.id.textView_time);mHolder.imageView_item_minci_on_line_type = (ImageView) convertView.findViewById(R.id.imageView_item_minci_on_line_type);convertView.setTag(mHolder);} else {mHolder = (ViewHolder) convertView.getTag();}Minci minci = list.get(position);mHolder.uname.setText(minci.getName());mHolder.departement.setText(minci.getDepartment());mHolder.job.setText(minci.getJos());mHolder.time.setText(minci.getTime());if (!minci.getImg().equals("")) {BitmapHelper.getBitmapUtils().display(mHolder.img, minci.getImg());}// 根据position获取分类的首字母的Char ascii值int section = getSectionForPosition(position);// 如果当前位置等于该分类首字母的Char的位置 ，则认为是第一次出现if (position == getPositionForSection(section)) {mHolder.textView_item_top.setVisibility(View.VISIBLE);if ("|".equals(minci.getFirst_char_by_uname().toUpperCase())) {mHolder.textView_item_top.setText("#");} else {mHolder.textView_item_top.setText(minci.getFirst_char_by_uname().toUpperCase());}} else {mHolder.textView_item_top.setVisibility(View.GONE);}mHolder.img.setType(RoundImageView.TYPE_CIRCLE);mHolder.minci.setVisibility(View.GONE);mHolder.time.setVisibility(View.GONE);mHolder.imageView_item_minci_on_line_type.setVisibility(View.VISIBLE);// TODO 不完善待改。。。。后面跟的终端类型。。。。。。。。。。。。。。。。。。。。。String devname = minci.getDevname();if ("pc".equals(devname)) {mHolder.imageView_item_minci_on_line_type.setImageDrawable(context.getResources().getDrawable(R.drawable.pccj));} else if (devname.length() >= 4&& devname.subSequence(0, 4).equals("ipad")) {mHolder.imageView_item_minci_on_line_type.setImageDrawable(context.getResources().getDrawable(R.drawable.ipadcj));} else if (devname.length() >= 4&& devname.subSequence(0, 6).equals("iPhone")) {mHolder.imageView_item_minci_on_line_type.setImageDrawable(context.getResources().getDrawable(R.drawable.iphonecj));} else if (devname.length() >= 4&& devname.subSequence(0, 7).equals("android")) {mHolder.imageView_item_minci_on_line_type.setImageDrawable(context.getResources().getDrawable(R.drawable.androicjd));}return convertView;}public class ViewHolder {private TextView uname;private TextView departement;private TextView job;private RoundImageView img;private TextView time;private TextView minci;private TextView textView_item_top;private ImageView imageView_item_minci_on_line_type;}/*** 根据ListView的当前位置获取分类的首字母的Char ascii值*/@Overridepublic int getSectionForPosition(int position) {return list.get(position).getFirst_char_by_uname().toUpperCase().charAt(0);}/*** 提取英文的首字母，非英文字母用#代替。* * @param str* @return*/private String getAlpha(String str) {String sortStr = str.trim().substring(0, 1).toUpperCase();// 正则表达式，判断首字母是否是英文字母if (sortStr.matches("[A-Z]")) {return sortStr;} else {return "#";}}@Overridepublic Object[] getSections() {return null;}/*** 根据分类的首字母的Char ascii值获取其第一次出现该首字母的位置*/public int getPositionForSection(int section) {for (int i = 0; i < getCount(); i++) {String sortStr = list.get(i).getFirst_char_by_uname();char firstChar = sortStr.toUpperCase().charAt(0);if (firstChar == section) {return i;}}return -1;}}

下面来说一下排序

/**
* 汉字转换成拼音的类
*/
private CharacterParser characterParser;
/**
* 根据拼音来排列比较器
*/
private PinyinComparator pinyinComparator;// 实例化汉字转拼音类characterParser = CharacterParser.getInstance();pinyinComparator = new PinyinComparator();//汉字转换成拼音  String pinyin = characterParser.getSelling(json需要排序的汉字);  String sortString = pinyin.substring(0, 1).toUpperCase();  // 正则表达式，判断首字母是否是英文字母  if(sortString.matches("[A-Z]")){  //存到实体类的一个变量minci.getFirst_char_by_uname.(sortString.toUpperCase());//变大写}else{minci.getFirst_char_by_uname.("#");}list.add(minci);}

汉字转拼音

/** * Java汉字转换为拼音 *  */
public class CharacterParser {  private static int[] pyvalue = new int[] {-20319, -20317, -20304, -20295, -20292, -20283, -20265, -20257, -20242, -20230, -20051, -20036, -20032,  -20026, -20002, -19990, -19986, -19982, -19976, -19805, -19784, -19775, -19774, -19763, -19756, -19751, -19746, -19741, -19739, -19728,  -19725, -19715, -19540, -19531, -19525, -19515, -19500, -19484, -19479, -19467, -19289, -19288, -19281, -19275, -19270, -19263, -19261,  -19249, -19243, -19242, -19238, -19235, -19227, -19224, -19218, -19212, -19038, -19023, -19018, -19006, -19003, -18996, -18977, -18961,  -18952, -18783, -18774, -18773, -18763, -18756, -18741, -18735, -18731, -18722, -18710, -18697, -18696, -18526, -18518, -18501, -18490,  -18478, -18463, -18448, -18447, -18446, -18239, -18237, -18231, -18220, -18211, -18201, -18184, -18183, -18181, -18012, -17997, -17988,  -17970, -17964, -17961, -17950, -17947, -17931, -17928, -17922, -17759, -17752, -17733, -17730, -17721, -17703, -17701, -17697, -17692,  -17683, -17676, -17496, -17487, -17482, -17468, -17454, -17433, -17427, -17417, -17202, -17185, -16983, -16970, -16942, -16915, -16733,  -16708, -16706, -16689, -16664, -16657, -16647, -16474, -16470, -16465, -16459, -16452, -16448, -16433, -16429, -16427, -16423, -16419,  -16412, -16407, -16403, -16401, -16393, -16220, -16216, -16212, -16205, -16202, -16187, -16180, -16171, -16169, -16158, -16155, -15959,  -15958, -15944, -15933, -15920, -15915, -15903, -15889, -15878, -15707, -15701, -15681, -15667, -15661, -15659, -15652, -15640, -15631,  -15625, -15454, -15448, -15436, -15435, -15419, -15416, -15408, -15394, -15385, -15377, -15375, -15369, -15363, -15362, -15183, -15180,  -15165, -15158, -15153, -15150, -15149, -15144, -15143, -15141, -15140, -15139, -15128, -15121, -15119, -15117, -15110, -15109, -14941,  -14937, -14933, -14930, -14929, -14928, -14926, -14922, -14921, -14914, -14908, -14902, -14894, -14889, -14882, -14873, -14871, -14857,  -14678, -14674, -14670, -14668, -14663, -14654, -14645, -14630, -14594, -14429, -14407, -14399, -14384, -14379, -14368, -14355, -14353,  -14345, -14170, -14159, -14151, -14149, -14145, -14140, -14137, -14135, -14125, -14123, -14122, -14112, -14109, -14099, -14097, -14094,  -14092, -14090, -14087, -14083, -13917, -13914, -13910, -13907, -13906, -13905, -13896, -13894, -13878, -13870, -13859, -13847, -13831,  -13658, -13611, -13601, -13406, -13404, -13400, -13398, -13395, -13391, -13387, -13383, -13367, -13359, -13356, -13343, -13340, -13329,  -13326, -13318, -13147, -13138, -13120, -13107, -13096, -13095, -13091, -13076, -13068, -13063, -13060, -12888, -12875, -12871, -12860,  -12858, -12852, -12849, -12838, -12831, -12829, -12812, -12802, -12607, -12597, -12594, -12585, -12556, -12359, -12346, -12320, -12300,  -12120, -12099, -12089, -12074, -12067, -12058, -12039, -11867, -11861, -11847, -11831, -11798, -11781, -11604, -11589, -11536, -11358,  -11340, -11339, -11324, -11303, -11097, -11077, -11067, -11055, -11052, -11045, -11041, -11038, -11024, -11020, -11019, -11018, -11014,  -10838, -10832, -10815, -10800, -10790, -10780, -10764, -10587, -10544, -10533, -10519, -10331, -10329, -10328, -10322, -10315, -10309,  -10307, -10296, -10281, -10274, -10270, -10262, -10260, -10256, -10254};  public static String[] pystr = new String[] {"a", "ai", "an", "ang", "ao", "ba", "bai", "ban", "bang", "bao", "bei", "ben", "beng", "bi", "bian",  "biao", "bie", "bin", "bing", "bo", "bu", "ca", "cai", "can", "cang", "cao", "ce", "ceng", "cha", "chai", "chan", "chang", "chao", "che",  "chen", "cheng", "chi", "chong", "chou", "chu", "chuai", "chuan", "chuang", "chui", "chun", "chuo", "ci", "cong", "cou", "cu", "cuan",  "cui", "cun", "cuo", "da", "dai", "dan", "dang", "dao", "de", "deng", "di", "dian", "diao", "die", "ding", "diu", "dong", "dou", "du",  "duan", "dui", "dun", "duo", "e", "en", "er", "fa", "fan", "fang", "fei", "fen", "feng", "fo", "fou", "fu", "ga", "gai", "gan", "gang",  "gao", "ge", "gei", "gen", "geng", "gong", "gou", "gu", "gua", "guai", "guan", "guang", "gui", "gun", "guo", "ha", "hai", "han", "hang",  "hao", "he", "hei", "hen", "heng", "hong", "hou", "hu", "hua", "huai", "huan", "huang", "hui", "hun", "huo", "ji", "jia", "jian",  "jiang", "jiao", "jie", "jin", "jing", "jiong", "jiu", "ju", "juan", "jue", "jun", "ka", "kai", "kan", "kang", "kao", "ke", "ken",  "keng", "kong", "kou", "ku", "kua", "kuai", "kuan", "kuang", "kui", "kun", "kuo", "la", "lai", "lan", "lang", "lao", "le", "lei", "leng",  "li", "lia", "lian", "liang", "liao", "lie", "lin", "ling", "liu", "long", "lou", "lu", "lv", "luan", "lue", "lun", "luo", "ma", "mai",  "man", "mang", "mao", "me", "mei", "men", "meng", "mi", "mian", "miao", "mie", "min", "ming", "miu", "mo", "mou", "mu", "na", "nai",  "nan", "nang", "nao", "ne", "nei", "nen", "neng", "ni", "nian", "niang", "niao", "nie", "nin", "ning", "niu", "nong", "nu", "nv", "nuan",  "nue", "nuo", "o", "ou", "pa", "pai", "pan", "pang", "pao", "pei", "pen", "peng", "pi", "pian", "piao", "pie", "pin", "ping", "po", "pu",  "qi", "qia", "qian", "qiang", "qiao", "qie", "qin", "qing", "qiong", "qiu", "qu", "quan", "que", "qun", "ran", "rang", "rao", "re",  "ren", "reng", "ri", "rong", "rou", "ru", "ruan", "rui", "run", "ruo", "sa", "sai", "san", "sang", "sao", "se", "sen", "seng", "sha",  "shai", "shan", "shang", "shao", "she", "shen", "sheng", "shi", "shou", "shu", "shua", "shuai", "shuan", "shuang", "shui", "shun",  "shuo", "si", "song", "sou", "su", "suan", "sui", "sun", "suo", "ta", "tai", "tan", "tang", "tao", "te", "teng", "ti", "tian", "tiao",  "tie", "ting", "tong", "tou", "tu", "tuan", "tui", "tun", "tuo", "wa", "wai", "wan", "wang", "wei", "wen", "weng", "wo", "wu", "xi",  "xia", "xian", "xiang", "xiao", "xie", "xin", "xing", "xiong", "xiu", "xu", "xuan", "xue", "xun", "ya", "yan", "yang", "yao", "ye", "yi",  "yin", "ying", "yo", "yong", "you", "yu", "yuan", "yue", "yun", "za", "zai", "zan", "zang", "zao", "ze", "zei", "zen", "zeng", "zha",  "zhai", "zhan", "zhang", "zhao", "zhe", "zhen", "zheng", "zhi", "zhong", "zhou", "zhu", "zhua", "zhuai", "zhuan", "zhuang", "zhui",  "zhun", "zhuo", "zi", "zong", "zou", "zu", "zuan", "zui", "zun", "zuo"};  private StringBuilder buffer;  private String resource;  private static CharacterParser characterParser = new CharacterParser();  public static CharacterParser getInstance() {  return characterParser;  }  public String getResource() {  return resource;  }  public void setResource(String resource) {  this.resource = resource;  }  /** * 汉字转成ASCII码 * * @param chs * @return */  private int getChsAscii(String chs) {  int asc = 0;  try {  byte[] bytes = chs.getBytes("gb2312");  if (bytes == null || bytes.length > 2 || bytes.length <= 0) {  throw new RuntimeException("illegal resource string");  }  if (bytes.length == 1) {  asc = bytes[0];  }  if (bytes.length == 2) {  int hightByte = 256 + bytes[0];  int lowByte = 256 + bytes[1];  asc = (256 * hightByte + lowByte) - 256 * 256;  }  } catch (Exception e) {  System.out.println("ERROR:ChineseSpelling.class-getChsAscii(String chs)" + e);  }  return asc;  }  /** * 单字解析 * * @param str * @return */  public String convert(String str) {  String result = null;  int ascii = getChsAscii(str);  if (ascii > 0 && ascii < 160) {  result = String.valueOf((char) ascii);  } else {  for (int i = (pyvalue.length - 1); i >= 0; i--) {  if (pyvalue[i] <= ascii) {  result = pystr[i];  break;  }  }  }  return result;  }  /** * 词组解析 * * @param chs * @return */  public String getSelling(String chs) {  String key, value;  buffer = new StringBuilder();  for (int i = 0; i < chs.length(); i++) {  key = chs.substring(i, i + 1);  if (key.getBytes().length >= 2) {  value = (String) convert(key);  if (value == null) {  value = "unknown";  }  } else {  value = key;  }  buffer.append(value);  }  return buffer.toString();  }  public String getSpelling() {  return this.getSelling(this.getResource());  }  }

安卓仿联系人索引列表 A到Z排序查询相关推荐

仿微信联系人索引列表ListView
IM 模块中经常用到字母索引 ListView 来做通讯录或者称联系人列表, 今天跟大家分享一个仿微信联系人索引列表, 优点是轻量级,简单易懂. 不要任何依赖 , jar包等效果预览工程结构 ...
android仿微信联系人索引列表
前言因为自己在做的一个小软件里面需要用到从A-Z排序的ListView,所以自然而然的想到了微信的联系人,我想要的就是那样的效果.本来没打算自己去写,想要第三方写好的东西,搜了几个之后发现有的太 ...
android 通讯录界面设计带字母,android仿微信联系人索引列表功能
前言因为自己在做的一个小软件里面需要用到从A-Z排序的ListView,所以自然而然的想到了微信的联系人,我想要的就是那样的效果.本来没打算自己去写,想要第三方写好的东西,搜了几个之后发现有的太复杂 ...
字母索引定位，仿联系人列表功能，实现字母A-Z排序
常见的联系人列表 A-Z排序功能,获取数据首字母,仿照联系人实现A-Z字母排序,实现字母索引定位功能:监听字母滑动,使recycleview滑动到指定位置: 先上效果图: 下面介绍实现逻辑: 自定义 ...
android 仿qq好友列表分组效果及联系人分组效果
历史记录仿QQ好友列表的动态效果以及联系人的分组效果 QQ朋友分组的功能做的不错,大家都很认可,那么到底他的分组并且滑动的时候,标题能停留在顶部是如何实现的呢?今天从网上搜索了一下资料,自己运行了 ...
uni-app 写小程序索引列表，仿微信通讯录
心里认定了一个女孩就要好好的珍惜对待她,人生不容辜负,你必须要更加努力 .加油骚年 uni-app 写小程序索引列表,仿微信通讯录去uni-app官网下载插件 indexlist <m ...
android的实现关注好友功能,android仿微信好友列表功能
android studio实现微信好友列表功能,注意有一个jar包我没有放上来,请大家到MainActivity中的那个网址里面下载即可,然后把pinyin4j-2.5.0.jar复制粘贴到项目的a ...
计算机毕业设计Python+uniapp+安卓仿网易云音乐客户端APP（WEB+APP+LW）
计算机毕业设计Python+uniapp+安卓仿网易云音乐客户端APP(WEB+APP+LW) 该项目含有源码.文档.程序.数据库.配套开发软件.软件安装教程项目运行环境配置: Pychram社区 ...
iOS之仿QQ好友列表展开收缩效果的实现
使用UICollectionView实现思路很明显整体它是一个列表,它的分组是一个列表,它里面的好友列表也是一个列表,所以就可以使用组头来设置分组列表,使用cell设置好友列表: 当点击组头的时候 ...

安卓仿联系人索引列表 A到Z排序查询

安卓仿联系人索引列表 A到Z排序查询相关推荐

最新文章

热门文章

安卓 仿联系人索引列表 A到Z排序查询

安卓 仿联系人索引列表 A到Z排序查询相关推荐

最新文章

热门文章

安卓仿联系人索引列表 A到Z排序查询

安卓仿联系人索引列表 A到Z排序查询相关推荐